home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / hypertxt / msdos / hyprvx11 / spawn < prev    next >
Text File  |  1990-11-09  |  4KB  |  100 lines
  1. SPAWN
  2.  
  3. Creates a subprocess of the current process. The context of the subprocess is
  4. copied from the current process. You can use the SPAWN command to leave MAIL
  5. temporarily, perform other functions (such as displaying a directory listing or
  6. printing a file), and then return to MAIL.
  7.  
  8. Format:        SPAWN [command]
  9.  
  10. Parameters:    command
  11.  
  12.                Specifies the DCL command string that executes in the context of
  13.                the created subprocess. When the command completes, the
  14.                subprocess terminates and control is returned to the parent       
  15.                process. If not specified, a subprocess is created transferring   
  16.                control to the DCL command level.
  17.  
  18. Qualifiers:    /INPUT
  19.  
  20.                /INPUT=file-spec
  21.  
  22.                Specifies an input file containing one or more DCL command        
  23.                strings to be executed by the spawned subprocess. If you specify  
  24.                a command string along with an input file, the command string is  
  25.                processed before the commands in the input file. Once processing  
  26.                is complete, the subprocess is terminated.
  27.  
  28.                /LOGICAL_NAMES
  29.  
  30.                /[NO]LOGICAL_NAMES
  31.  
  32.                Specifies that the logical names of the parent process be copied
  33.                to the subprocess. When you do not want the subprocess to use
  34.                the logical names of the parent process, enter the                
  35.                /NOLOGICAL_NAMES qualifier. The default is /LOGICAL_NAMES.
  36.  
  37.  
  38.                /OUTPUT
  39.  
  40.                /OUTPUT=file-spec
  41.  
  42.                Identifies the output file to which the results of the SPAWN
  43.                operation are written. You should specify an output other than    
  44.                SYS$OUTPUT whenever you specify the /NOWAIT qualifier to prevent  
  45.                output from being displayed while you are specifying new          
  46.                commands. If you omit the /OUTPUT qualifier, output is written 
  47.                to the current SYS$OUTPUT device.
  48.  
  49.                /PROCESS
  50.  
  51.                /PROCESS=subprocess-name
  52.  
  53.                Specifies the name of the subprocess to be created. The           
  54.                default name of the subprocess is USERNAME_n.
  55.  
  56.                /SYMBOLS
  57.  
  58.                /[NO]SYMBOLS
  59.  
  60.                Determines whether the system passes DCL global and local
  61.                symbols to the subprocess. The default is /SYMBOLS.
  62.  
  63.                /WAIT
  64.  
  65.                Controls whether the system waits until the subprocess is
  66.                completed before allowing more commands to be specified. The
  67.                /NOWAIT qualifier allows you to specify new commands while the
  68.                specified subprocess is running. If you specify /NOWAIT, you
  69.                should also use /OUTPUT to direct the output to a file rather     
  70.                than displaying it on the screen to prevent your terminal from    
  71.                being used by more than one process simultaneously.
  72.  
  73.  
  74. Examples:
  75.  
  76.       1.
  77.            MAIL> SPAWN SHOW TIME
  78.  
  79.                     This example shows how to create a subprocess containing 
  80.                     the DCL command SHOW TIME while you are in MAIL.
  81.  
  82.       2.
  83.            MAIL> SPAWN /NOLOGICAL_NAMES SET HOST
  84.            _Node: MARS
  85.               .
  86.               .
  87.               .
  88.            $ LOGOUT
  89.            CRAMMER logged out at ...
  90.  
  91.            %REM-S-END, control returned to node _BETA::
  92.  
  93.            MAIL>
  94.  
  95.                     This example shows how to use the SPAWN command to create a
  96.                     subprocess in which you SET HOST to another node. When you   
  97.                     want to leave node MARS and move back to node BETA, enter    
  98.                     the LOGOUT command. The /NOLOGICAL_NAMES qualifier prevents  
  99.                     the logical names of the parent process from being copied to 
  100.                     the subprocess.